[PATCH] RE: [Xen-devel] DOM0_GETDOMAININFO intended behavior
Ok... now that I (unintentionally) went overboard on this, why not just
document how it works and leave it as is?
signed-off-by: dsteklof@us.ibm.com
signed-off-by: ian@xensource.com
cwc22@centipede.cl.cam.ac.uk
djm@kirby.fc.hp.com
doogie@brainfood.com
+dsteklof@us.ibm.com
gm281@boulderdash.cl.cam.ac.uk
gm281@tetrapod.cl.cam.ac.uk
hollisb@us.ibm.com
u32 domid,
int cpu);
/**
- * This function will return information about one or more domains.
+ * This function will return information about one or more domains. It is
+ * designed to iterate over the list of domains. If a single domain is
+ * requested, this function will return the next domain in the list - if
+ * one exists. It is, therefore, important in this case to make sure the
+ * domain requested was the one returned.
*
* @parm xc_handle a handle to an open hypervisor interface
* @parm first_domid the first domain to enumerate information from. Domains